home *** CD-ROM | disk | FTP | other *** search
/ Collection of Tools & Utilities / Collection of Tools and Utilities.iso / batchut / chooser.zip / CHOOSE.DOC < prev   
Text File  |  1987-09-24  |  6KB  |  179 lines
  1.    CHOOSE 4.1            TECHNICAL NOTES        SAPPHIRE SOFTWARE
  2.  
  3.  
  4.    CHOOSE Version 4.1
  5.    TECHNICAL NOTES
  6.  
  7.  
  8.    CHOOSE lets you generate custom menus from batch files. With
  9.    CHOOSE, you can create Super easy to use, multiple choice
  10.    menus, or a single-item menu that respond to a YES/NO answer.
  11.    Your CHOOSE batch files can provide lists of different
  12.    applications or programs, ask if you'd like to park the hard
  13.    disk upon exiting a utility, or issue any other prompt for
  14.    action.
  15.  
  16.  
  17.    COMMANDS AND PARAMETERS:
  18.  
  19.    Creating a menu is easy with CHOOSE.  Just enter the following
  20.    command and parameter list as shown below:
  21.  
  22.        CHOOSE (1st_menu_item) (2nd_menu_item) (nth_menu_item)
  23.  
  24.  
  25.    Parenthesis are not necessary.  Separate menu items with a
  26.    single space.  Use underscore marks (_) to enter multiple word
  27.    menu item, such as "backup_disk".  If you enter parameters
  28.    that are too similar, CHOOSE displays the following error
  29.    message:
  30.  
  31.              ERROR: Parameters too similar.
  32.  
  33.  
  34.    Find a new name for one of the choices and re-enter the
  35.    parameters.  (If you forget how CHOOSE works, just type CHOOSE
  36.    at any DOS prompt and you will get instant help.)
  37.  
  38.  
  39.    YES/NO PROMPTS:
  40.  
  41.    If you specify only one menu item in the command line, CHOOSE
  42.    assumes that you want a YES/NO question prompt.  In this case,
  43.    CHOOSE automatically displays a question mark with the single
  44.    prompt.  You may then type Y to answer Yes to this prompt.
  45.    Your answer appears in highlighted characters.  No is the
  46.    default answer and may be entered by pressing N or any other
  47.    key.
  48.  
  49.    For example, to have a batch file automatically ask if you'd
  50.    like the hard disk parked, enter the following CHOOSE command
  51.    line in the appropriate batch file:
  52.  
  53.            CHOOSE Do_you_want_to_park_the_disk
  54.  
  55.    When you run this batch file, the following prompt appears:
  56.  
  57.              Do you want to park the disk?
  58.  
  59.  
  60.    Type Y or N.  Your choice then appears in highlighted
  61.    characters.
  62.  
  63.  
  64.    MULTIPLE CHOICE MENUS:
  65.  
  66.    To create custom CHOOSE menus that display multiple choices,
  67.    enter two or more menu parameters in the command line.  You
  68.    may enter any number of items, and layer menus to any depth.
  69.    For example, you can set-up menus to choose a word processing
  70.    application from a list of applications, and then select a
  71.    specific word processor from a list of many.  When you run the
  72.    batch file with the command line, CHOOSE displays the word
  73.    "SELECT" and the menu choices.  The first unique letter in
  74.    each choice is highlighted.  For example, enter the following
  75.    command line to select one of four programs:
  76.  
  77.          CHOOSE DiskTach Lotus_123 WordStar Demon_Wars
  78.  
  79.  
  80.    When you run the batch file with this command, CHOOSE displays
  81.    the following prompt:
  82.  
  83.          Select: DiskTach, Lotus 123, WordStar or Demon Wars.
  84.  
  85.  
  86.    The "D" in the first item, the "L" in the second, the "W"
  87.    in the third, and the "e" in the fourth are all highlighted
  88.    and you may choose an item by typing this highlighted letter.
  89.    To exit any menu without making a choice, press the ESC
  90.    (escape) key.
  91.  
  92.  
  93.    COMMAND LINE PARAMETERS:
  94.  
  95.    The /? parameter may be entered with CHOOSE to ask for instant
  96.    help.
  97.  
  98.    The /v parameters (means "vertical") may be entered at the end
  99.    of the command line for a vertical display.  For example, for
  100.    a vertical menu of three Sapphire Software programs, enter
  101.    the following:
  102.  
  103.              CHOOSE VidLib DiskTach Remind /v
  104.  
  105.    The CHOOSE display now looks like this:
  106.  
  107.              Select:  VidLib,
  108.                       DiskTach
  109.                   or  Remind.
  110.  
  111.    Note: If you specify more choices than would fit on a single
  112.    line, the /v mode is entered automatically.
  113.  
  114.  
  115.    SAMPLE BATCH FILE:
  116.  
  117.    The following batch file is included as an example of how to
  118.    create a CHOOSE menu.  In the example, the CHOOSE menu lets
  119.    you choose between several useful programs.
  120.  
  121.              echo off
  122.              :top
  123.              cls
  124.              choose Turbo_Pascal WordStar Lotus_123 Exit_to_DOS
  125.              if errorlevel 4 goto end
  126.              if errorlevel 3 goto lo
  127.              if errorlevel 2 goto ws
  128.              if errorlevel 1 goto pas
  129.              goto top
  130.              :pas
  131.              cd c:\turbo
  132.              turbo
  133.              goto top
  134.              :ws
  135.              choose Do_you_want_TurboLightning
  136.              if errorlevel 1 goto tlyes
  137.              goto skip
  138.              :tlyes
  139.              cd c:\light
  140.              light
  141.              :skip
  142.              cd c:\wp
  143.              ws
  144.              goto top
  145.              :end
  146.  
  147.  
  148.  
  149.    CHOOSE is a copyright of Sapphire Software (c) 1987.
  150.  
  151.    Sapphire Software - every program's a gem.
  152.  
  153.    Other Sapphire Software programs are available to customize
  154.    and personalize your computer.  These programs are available
  155.    via ShareWare, or direct from Sapphire Software.  If you like
  156.    this program and find it useful, give a copy to a friend.
  157.    Then show your support for low-cost quality software by
  158.    sending a check for a measly $5.00 made out to:
  159.  
  160.  
  161.                      Sapphire Software
  162.                      Suite 166
  163.                      4141 Ball Road
  164.                      Cypress, CA 90630-3465
  165.  
  166.    We encourage you to copy this program to other bulletin
  167.    boards, and freely give it to all your friends and enemies.
  168.  
  169.    WARRANTY
  170.  
  171.    Please note that changes or alterations to this program of any
  172.    kind are not authorized by Sapphire Software.  The software
  173.    must be distributed as is.  Sapphire Software makes no
  174.    warranty about this program as regards its suitability for any
  175.    purpose, or its ability to perform under conditions not set
  176.    down in the program documentation.  By using this program, the
  177.    user agrees that Sapphire Software shall not be liable for any
  178.    damages in connection with or arising from use of this
  179.    program.